home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / vacation.z / vacation
Text File  |  1998-10-20  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))                                                        VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vacation - return ``I am not here'' mail indication
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _I_n_i_t_i_a_l_i_z_i_n_g _t_h_e _d_a_t_a_b_a_s_e:
  13.  
  14.      vvvvaaaaccccaaaattttiiiioooonnnn ----iiii [ ----rrrr _i_n_t_e_r_v_a_l ]
  15.  
  16.      _R_e_p_l_y_i_n_g _t_o _m_a_i_l:
  17.  
  18.      vvvvaaaaccccaaaattttiiiioooonnnn [ ----aaaa _a_l_i_a_s ] _u_s_e_r_i_d
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _V_a_c_a_t_i_o_n automatically returns a message to anyone who sends you mail.
  22.      Typically, this message informs the sender that you are not available to
  23.      read your mail.
  24.  
  25.    IIIInnnniiiittttiiiiaaaalllliiiizzzziiiinnnngggg tttthhhheeee DDDDaaaattttaaaabbbbaaaasssseeee
  26.      When called with the ----iiii flag, _v_a_c_a_t_i_o_n initializes the _n_d_b_m(3B) database
  27.      files ._v_a_c_a_t_i_o_n._p_a_g and ._v_a_c_a_t_i_o_n._d_i_r in your home directory.  If a
  28.      vacation database already exists, _v_a_c_a_t_i_o_n will delete the old one and
  29.      create a new (empty) one.  _v_a_c_a_t_i_o_n uses this database to keep track of
  30.      the people to whom it has sent messages and at what times such messages
  31.      were sent.  _v_a_c_a_t_i_o_n requires this information to implement the reply
  32.      interval function described below.
  33.  
  34.      The ----rrrr flag causes _v_a_c_a_t_i_o_n to set the reply interval to _i_n_t_e_r_v_a_l days.
  35.      The reply interval is the time the system will wait before sending a
  36.      duplicate notification message to the same user.  For example, if the
  37.      reply interval is set to 3 days, then no matter how frequently a given
  38.      user sends you mail, he will be sent a notification message at most once
  39.      every 3 days.  This feature reduces unnecessary mail traffic for the
  40.      system and undue irritation for those who send you mail.
  41.  
  42.      An interval of ``0'' means that a reply is sent to each message, and an
  43.      interval of ``infinite'' (actually, any non-numeric character) will never
  44.      send more than one reply.
  45.  
  46.      The default interval is seven days.
  47.  
  48.      CCCCaaaavvvveeeeaaaatttt:::: An interval of ``0'' is quite dangerous as it allows mailers to
  49.      get into ``I am on vacation'' loops.
  50.  
  51.    RRRReeeeppppllllyyyyiiiinnnngggg ttttoooo MMMMaaaaiiiillll
  52.      When called without the ----iiii flag, _v_a_c_a_t_i_o_n sends an automatic reply
  53.      message.  _v_a_c_a_t_i_o_n will expect to see an incoming mail message on
  54.      standard input.  Once the message has been collected, _v_a_c_a_t_i_o_n will send
  55.      an automatic reply to the sender of the incoming mail message provided
  56.      that all of the following are true:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))                                                        VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))
  71.  
  72.  
  73.  
  74.      1. _u_s_e_r_i_d (or an _a_l_i_a_s supplied using the ----aaaa option) is part of either
  75.         the ``To:'' or ``Cc:'' headers of the mail.
  76.  
  77.      2. No automatic reply has been sent to the sender within the configured
  78.         _i_n_t_e_r_v_a_l days. (See the ----iiii and ----rrrr flags above.)
  79.  
  80.      3. The sender of the incoming message is not ``???-REQUEST'',
  81.         ``Postmaster'', ``UUCP'', ``MAILER'', or ``MAILER-DAEMON'' (where case
  82.         doesn't matter).
  83.  
  84.      4. No ``Precedence: bulk'' or ``Precedence: junk'' line is included in
  85.         headers of the incoming mail message.
  86.  
  87.      The automatic reply message will be read from the ._v_a_c_a_t_i_o_n._m_s_g file in
  88.      the home directory associated with _u_s_e_r_i_d. This file should contain the
  89.      complete mail message (including headers) which will be sent back to the
  90.      sender.  If it does not include a ``Subject:'' line, _v_a_c_a_t_i_o_n will
  91.      construct one using the ``Subject:'' line from the incoming message.
  92.  
  93.      _V_a_c_a_t_i_o_n reads the first line from the standard input for a UNIX-style
  94.      ``From'' line to determine the address of the sender.  _s_e_n_d_m_a_i_l(1M)
  95.      includes this ``From'' line automatically.  Note that if the incoming
  96.      message contains a ``Reply-To:'' message header, _v_a_c_a_t_i_o_n will send its
  97.      reply message to the address listed there instead of to the address from
  98.      the ``From'' line.
  99.  
  100. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  101.      To configure _v_a_c_a_t_i_o_n so that it will automatically return a message to
  102.      each person who sends you mail, you will need to take the following
  103.      steps:
  104.  
  105.      1. Create a ._v_a_c_a_t_i_o_n._m_s_g file in your home directory containing the
  106.         message that you want _v_a_c_a_t_i_o_n to return to each sender.  It should be
  107.         a complete message (including headers).  If your name was ``John
  108.         Brown,'' your userid was ``john'' and your host name was
  109.         ``mymachine.company.com'', you might create a ._v_a_c_a_t_i_o_n._m_s_g file
  110.         containing:
  111.  
  112.           From: john@mymachine.company.com (John Brown)
  113.           Precedence: bulk
  114.  
  115.           I am on vacation until Aug. 1st.  In my absence, please refer
  116.           all urgent business to Jane Smith.  Her e-mail address is
  117.           jane@hermachine.company.com.
  118.  
  119.                -- John Brown
  120.  
  121.  
  122.      2. Initialize the vacation database in your home directory by invoking
  123.         _v_a_c_a_t_i_o_n with the ----iiii flag and, optionally, the ----rrrr flag.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))                                                        VVVVAAAACCCCAAAATTTTIIIIOOOONNNN((((1111))))
  137.  
  138.  
  139.  
  140.      3. Create a ._f_o_r_w_a_r_d file in your home directory that tells _s_e_n_d_m_a_i_l(1M)
  141.         to pass incoming mail to the _v_a_c_a_t_i_o_n program.  Again, if your name
  142.         was ``John Brown'' and your userid was ``john,'' your ._f_o_r_w_a_r_d file
  143.         might have:
  144.  
  145.           \john, "|/usr/sbin/vacation john"
  146.  
  147.  
  148.         This will cause _s_e_n_d_m_a_i_l(1M) to send one copy of the incoming message
  149.         to your regular mailbox (so you can read it when you get back) and one
  150.         copy of the message to the _v_a_c_a_t_i_o_n program.  Note that the _v_a_c_a_t_i_o_n
  151.         program is called such that it will reply to any messages for
  152.         ``john.''
  153.  
  154. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  155.      Fatal errors, such as calling _v_a_c_a_t_i_o_n with incorrect arguments, or with
  156.      non-existent _u_s_e_r_i_ds, are logged in the system log file, using
  157.      _s_y_s_l_o_g(3B).
  158.  
  159. FFFFIIIILLLLEEEESSSS
  160.      ~/.vacation.dir    database file
  161.      ~/.vacation.msg    message to send
  162.      ~/.vacation.pag    database file
  163.  
  164. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  165.      ndbm(3B), sendmail(1M), syslog(3B).
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.